LS-DOS™ 6.3 UPDATE FOR TRSDOS® 6.2.X 







The LS-DOS 6.3 release is an upgrade for the TRSDOS 6.2 operating system. Several impor¬ 
tant changes have been made to extend and enhance the operating system and its utilities. 
The date ranging has been expanded to accept dates through the year 1999. Files will now 
carry a modification time as well as a date. The DATECONV/CMD program is provided to 
translate version 6.2 or earlier disks to the 6.3 style dating. The user password has been el¬ 
iminated from the system. The owner password still remains. The library command ID was 
added to display a customer service number. Several enhancements have been made to 
BASIC. The new DISKCOPYICMD program will duplicate 5" double density floppy disks. 

Because the LS-DOS 6.3 update is a series of enhancements to TRSDOS 6.2, the primary do¬ 
cumentation remains the 6.2 manual and Technical Reference manual. If you have a version 
of TRSDOS earlier than 6.2, you can obtain the manuals from Radio Shack under the catalog 
numbers 26-0316 ( TRSDOS Version 6 [6.2 DOS manual and disk]), 26-2110 ( Model 4/4D 
[6.2] Technical Reference Manual), or 26-1117 (6.2 DOS manual only). This documentation 
should be treated as an addendum to the TRSDOS 6.2 information. 

LS-DOS 6.3 installation instructions 


Before performing the upgrade, it is recommended that you make several backup copies of the 
6.3 master disk. The simplest way to do this is to boot your system using the 6.3 diskette, in¬ 
sert a blank diskette to receive the copy in drive 1, and type the command: 


DISKCOPY :0 


:1 ENTER 


When the copy finishes, you can insert another destination diskette and make another copy. 


IMPORTANT NOTE 


It is important that you DO NOT switch between version 6.3 and any earlier version system 
disk in drive 0 without rebooting the computer. 

To update your existing TRSDOS 6.2 disks, boot up with a fresh copy of your new 6.3 sys¬ 
tem disk. The 6.3 system disk should remain in drive 0 throughout the update procedure. 
There are two separate methods for updating 6.2 floppy disks, depending on whether they are 
system disks or data disks. 

Updating DATA disks 

Place the DATA disk in drive 1 and issue the command: 


DATECONV :1 | ENTER 1 
This completes the conversion of the data disk. 

Updating SYSTEM disks 

Updating system disks may take two or three steps. Place the 6.2 disk in drive 1, and issue 
the command: 


BACKUP :0 :1 


( I / S/ OLD) |ENTER| 


If you wish to use the new BASIC enhancements, type the command: 
BACKUP BASIC : 0 :1 (I) IENTER' 
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Once the backups are completed, give the command: 


DATECONV : 1 | ENTER | 

This completes the updating of a system disk. At this time, you can add any of the new utili¬ 
ty files you wish. 

IMPORTANT NOTE: If you have sysgened a configuration file, you will have to re-create it 
the next time you boot the disk. 

Updating HARD disks 

For most hard disk installations, the following instructions can be used. Boot up the hard disk 
as you normally would. Typically your system will have the hard disk as drive 0, and the 
first floppy drive as drive 4. Place the 6.3 disk in drive 4, and type the following commands: 

BACKUP : 4 :0 (I,S)|ENTER| 

DATECONV : 0 |ENTER) 


Remove the 6.3 disk from drive 4, and insert your normal hard disk boot diskette. Type the 
following commands: 


BACKUP : 0 : 4 (I, S, OLD ) [ENTER] 
DATECONV : 4 1 ENTER 1 
MEMORY (A=X' 3B', B=0)| ENTER] 
MEMORY (A=X / 85' , B= 99 )| ENTER 
MEMORY (A="Y",B=255)|ENTER| 
SYSGEN (D=4) [ENTER] 


Now, reboot the system and use DATECONV on your other 6.2 hard drive partitions. 

IMPORTANT NOTE: If your hard drive configuration has system files sysgened in memory, 
you will have to re-create the configuration file after putting the 6.3 operating system on your 
hard drive and on your booting floppy disk. 

Reformatting hard drives 

If you ever have to reformat a hard drive using the TRSFORM6/CMD program that comes 
with TRSDOS 6.2, you should use the DATECONV utility after formatting is complete. This 
will make sure the hard drive is marked as being version 6.3. Alternatively, you can apply 
the following patch to TRSFORM6/CMD that will permanently alter it to format version 6.3 
partitions. 


•Patch TRSFORM6/CMD.UTILITY for 6.3 compatibility 

D04,C0=88 

F04,C0=80 

D05/01=63 

F05,01=62 

D09/2B=33 

F09,2B=32 

D0D,AA=63 

FOD,AA=62 
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VERSION 6.3 UPDATE INFORMATION 





This section describes the changes to existing commands, and explains the new commands 
and utility programs. You can continue to use your 6.2 disks with version 6.3 as long as you 
update them as explained in the installation instructions. The following is a brief guide to 
version compatibility. 

USING 6.2 OR EARLIER DISKS WITH 6.3 - Disks from earlier versions of TRSDOS 
should be converted with the new DATECONV/CMD program before being used with 6.3. 
Unconverted disks, will work, but the time and date information will not be correct. If a disk 
that was written on by 6.3 is used with an earlier version DOS, it may appear to have an unk¬ 
nown user password. If the file was previously password protected, access may not be possi¬ 
ble without knowing the owner password. To prevent this, use the COPY library command 
with the (CLONE=NO) parameter when moving from version 6.3 to earlier versions. 

USING 6.3 DISKS WITH EARLIER VERSIONS - This normally should not be done if the 
disk is to be used again with 6.3, as the year and time information will not be correct if the 
disk is written on. 

USING LDOS DISKS WITH 6.3 - Files can be moved from LDOS 5.1 disks to 6.3 disks 
with either the COPY library command or with a backup by class. When moving files from 
6.3 to LDOS 5.1 disks, with the COPY command, the parameter (CLONE=NO) should be 
used. The DATECONV program will not work on LDOS 5.1 disks. 

Boot up changes 

Since version 6.3 now stores a modification time as well as a date, you will be prompted for 
the time when booting the computer. Y ou can ent er the hours, minute, and seconds, or just 
the hours and minutes. Pressing only | ENTER 1 for this prompt will start the time at 
00:00:00. If you wish to suppress the time prompt, give the command SYSTEM 
(TIME=OFF) once the DOS Ready prompt appears. If you wish to reactivate the prompt 
after you have turned it off, use the command SYSTEM (TIME=ON). These commands do 
not have to be sysgened. 

Library command changes 

ATTRIB - The user password field has been removed from all files, so the USER parameter 
is no longer accepted. The system now assumes a blank user password for all files. If a pro¬ 
tection level has not been assigned to a file, full access will automatically be granted regard¬ 
less of any owner password. The owner password will still be required for full access on 
password protected files that have a protection level other than FULL. To have a file that al¬ 
lows no access whatsoever without the use of the owner password, change the protection level 
to NO (or NONE). Although the documentation for the ATTRIB library command lists 
EXEC as the highest protection level, the use of NO is valid and provides the highest level of 
protection. 

COPY - When copying from a 6.2 or earlier version disk to a 6.3 disk, the old user password 
(if any) will be removed and the 6.3 style date/time information field will be established, with 
the time being set to 12:00am. 

DATE - The acceptable range of dates is from January 1, 1980 to December 31, 1999. 

DIR - The directory display now shows a mod time immediately following the mod date for 
all 6.3 diskettes. The time will be in 12-hour format, with AM or PM indicated. Disks from 
earlier versions of TRSDOS will display a blank time field. 

ID - A new library command that displays a customer service number. This number is in¬ 
stalled when a master disk is manufactured, and is linked to the serial number that displays on 
boot up and to other embedded numbers. You must have this number when calling or writing 
for customer service on LS-DOS 6.3. 
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TIME - The time may now be entered with the seconds being optional. The full syntax for 
the TIME command is: 

TIME [HH:MM[:SS]] [(CLOCK=ON\OFF)] 

Utility Program changes 

BACKUP - When doing a backup by class from a 6.2 or earlier version disk to a 6.3 disk, 
the user password (if any) will be removed and the 6.3 style date/time information will be es¬ 
tablished. It will NOT be permissible to backup SYSTEM files from a 6.2 or earlier disk to a 
6.3 disk during a backup by class. 

DATECONV/CMD - Converts pre-6.3 version data (non-system) disks to use the new 
time/date format. The syntax is: 

DATECONV :d 

There are no parameters for this program. If conversion of a SYSTEM disk is attempted, an 
appropriate error message will be displayed. To convert this type of disk, you must first use 
BACKUP to move 6.3 system files onto it before using DATECONV. For example, 

BACKUP :d (S,I,OLD) 

Data disks from versions earlier than 6.3 will be converted in all cases and marked as a 6.3 
type disk. 

Conversion of LDOS 5.1 formatted disks is not allowed. Although these disks can be read 
and written to, the time and year will not be updated on modified files. Files should be 
copied or backed-up onto 6.3 formatted disks. 

DATECONV does not normally need to be used on a 6.3 disk, since the COPY and BACKUP 
commands automatically adjust the time/date storage when moving from LDOS or TRSDOS 
6.x to 6.3. For this reason you should NEVER move files to a 6.3 disk when booted up under 
any earlier version. If you do use DATECONV on a 6.3 disk, only those files that have an 
old style blank user password will be changed. This is to protect the time stamp on proper 
6.3 files. 

DISKCOPY/CMD - Performs a single-pass format and copy of a 5" double density floppy 
disk. It will duplicate both single and double sided disks. Attempting to copy other types of 
disks will abort the program with an appropriate error message. The syntax is: 

DISKCOPY :s :d 

The :s and :d are the source and destination drive numbers, respectively, and cannot be the 
same drive. After starting DISKCOPY, you will be prompted to insert the source and destina¬ 
tion disks. 

After the copy is co mplet e, you will be prompted to do another copy. If you wish to copy 
another disk, press the [3 key. You can change both the source and destination disks at this 
point if you desire. Pressing |N] will exit back to DOS Ready. 

If an error is encountered during the copy, the program will display the error and return to 
DOS Ready. 
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TED - ASCII Text Editor 


The Text EDitor (TED) is a full screen "quick" text editor with typical word-processing type 
features (four-directional) cursor movement; bi-directional scrolling; text directional delete; 
large text buffer; etc); however, TED was not designed to be a full featured word processor. 
TED was designed for you to be able to rapidly enter a full-screen text editing environment 
while accomplishing many of your text file editing tasks. 

Summary of editing commands 

The following are the command keys and their functions as used in TED. Once you become 
familiar with the operation of TED, this section may be all you need to refer to from to time 
to time to jog your memory. 

Action Key Entry 


Move the cursor one position left 


J or 

CTRL 

H 

Move the cursor one position right 

~2 

[| or 

CTRL 

m 

Move the cursor one position down 

T 

or [( 

7TRL\ 

t 

Move the cursor one position up 

t 

or ( 

:trl 

K| 

Move the cursor to the beginning of the line 

SHIFT 

4-1 


Move the cursor to the end of the line 

SHIFT 

-H 


Move the cursor to the end of the text 

SHIFT 

1 



Move the cursor to the beginning of the text 

SHIFT 

t 



Toggle overstrike/insert modes 

CTRL 

A 



Specify a BLOCK... 

CTRL 

B 



Specify DELETE 

CTRL 

[D 



FILE the text buffer to disk 

CTRL 

m 



Go find the next search string match 

LOAD a text file into the buffer 

[CTRL] 

CTRL 

0 

E 


Command confirmation or advance to next line 

ENTEB 

l\ or CTRL| M 

Go to the NEXT video page 

CTRL 

N 



REPLACE searched string with new string 
SEARCH for a string 

CTRL 

CTRL 

R 

s| 



Go UP to the previous video page 

CTRL 

u 



EXIT the text editor 

CLEAI 

l||SHIFT|| = | 


Invoking TED 

TED is invoked via the command: 

TED 

TED will display a welcome message on the bottom line of the display. This line will also be 
used for the display of status, prompting, and error messages. TED displays three different 
types of messages during its operation. Error messages are indicated by a trailing exclamation 
point, !. Queries which need a response are indicated by a trailing question mark, ?. All 
other messages are informative messages. Thus, Marker! is an error, String? is a query, 
and Block is informative. 
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Text entry modes 

TED will accept only displayable ASCII characters in the range 20H through 7FH for text en¬ 
try. Any other character will be interpreted as a command entry. 


TED operates in two text entry modes: overstrike and insert. The initial mode established 
when TED is first invoked is die "overstrike" mode. While TED is in "overstrike" mode, it 
will use an underscore as the cursor character. When you toggle to "insert" mode, the cursor 
is chang ed to a full graphics block. You toggle from one mode to the other via the 


nge 

111 


cttoia command. 


When TED is in "overstrike" mode, any acceptable character that is typed is written over the 
char acter whi ch appears under the blinking cursor. You can overs trike a newline character 
(i.e. 1 ENTER | , which is displayed as small graphics block). You can also overstrike either a 
"begin" block marker or an "end" block marker. You can be in overstrike mode when you 
come to the end of the text (or starting from an empty text buffer, for that matter) and still be 
able to enter text in this mode. 


When you switch to "insert" mode, anytime you enter acceptable text, the existing text will be 
pushed down one position starting from the character under the cursor to make room for the 
inserted character. The display will be constandy updated as text is inserted. 

The text entry mode is only changed via the | CTRL 11X1 command. Going into "delete" mode 
does not change the mode of text entry. 

Loading a text file 

The lCTRL|fL] command is used to load a text file into TED. When you enter |CTRL|lL] , 
you will be prompted for the name of the file. If the extension is omitted from your entry, 
"/TXT’ will be automatically provided. 


The LOAD command will not automatically clear any text remaining in the text buffer prior 
to the LOAD. The new text is not inserted at the cursor position but rather is appended to the 
end of the current te xt. If yo u wish to load t he new file over t he old te xt, simply invoke the 
command sequence, | SHIFT l it] followed by |CTRL|[D] then |SHIFT| |T]. This will delete 
the entire text buffer. 


If the file is too large to fit into the available text buffer, the error message No room! will 
be displayed and no text will be loaded. If any disk read error is encountered while reading 
the text file into the text buffer, the message I/O error! will be displayed. The text 
which was loaded up to the point of encountered the error will be retained in the text buffer. 
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Entering text 

Entering text is easy, you just type away. If you already have text in the buffer and wish to 
enter ne w text at the end of the document, just move the cursor to the bottom (via the 
| SHIFT| [T] key), then type in your text. If you wish to enter text at some other point, just 
position the cursor, toggle to the insert mode, then type away. TED will stay in insert mode 
until explicitly toggled back to overstrike mode. 

As you are entering text, any word which is too long to fit at the end of a video line will be 
split at the 80th column and continued onto the next line. These long words are not automati¬ 
cally moved onto the next line, as is the case with the typical word processor. 

Cursor positioning manipulations 

The ARROW keys are the primary tools to move the cursor. They will move the cursor in 
the direction indicated by the arrow. The shifted keys will be interpreted as cursor movement 
commands unless TED is in the DELETE or BLOCK modes. 


The | SHIFT 11 <—1 command will move the cursor to the first column of the current line. The 
~ HEFT||^»1 command will move the cursor to the last character of the current li ne. You can 
sition the cursor to the first character of the text buffer by using 1 SHIFT] PH. Finally, 
SHIFT | [T] positions to the end of text. 


poi 

S 


The page up, ICTRLIfU] , command will redraw the video screen so that the first displayed 
line is t wenty one lines previous to the current first displayed line. The page next command, 
| CTRL | [N] , will redraw the video screen so that the first line displayed is die last line of the 
current displayed text. If the video display has fewer than 22 lines of text displayed, the page 
next request will be ignored. 


Text deletion 


TED provides five forms of text deletion in addition to the block deletion discussed later. To 
delete t he single character which appears under the cursor, invoke the delete command via 
CTRLIfDl . This action will get rid of t he chara cter and all text which follows that character 
will be pulled back one position. The ICTRLlfDj command also puts you into DELETE 
mode which is made apparent by the display of the word Delete in the status line. The 
DELETE mode is active for only the next keyboard entry. There are only four subcommands 
associated with the DELETE mode: delete to beginning of line (bol), delete to end of line 
(eol), delete to top, and delete to bottom. TED will always prompt before performing one of 
these operations. 


Deletion desired Command sequence 


delete to bol 
delete to eol 
delete to top 
delete to bottom 


CTRL 

D 

then 

SHIFT 

<T- 

Ctrl 

D 

then 

SHIFT 

-» 

CTRL 

D 

then 

SHIFT 

T 

CTRL 

D 

then 

SHUT 

1 


After typing |CTRL||D] , the character now under the cursor is the character which was to the 
right of the deleted character. Since in the case of delete to bol and delete to top, you are 
deleting text which is in front of the cur sor, you really don’t want to delete the character 
which is under the cursor after the |CTRL|[D] . Well, you don’t have to worry about that be¬ 
cause those two subcommands properly back up one position before continuing the deletion. 
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Block operations 

The BLOCK command, [CTRLlfB] , has five subcommands: Begin, End, Copy, Delete, and 
Move, These subcommands are specified by entering the first letter of the subcommand word 
(fB~| , [E], jC], [D], or [M]). The letter may be in either upper or lower case. Note that these 
subcommands are NOT control key combinations but normal alphabetic single-key entries. 
When you invoke the BLOCK command, the word Block will be displayed in the status 
line. 


Any time you need to deal with a block; say to copy it, move it, or delete it, you have to first 
mark it. The beginning and ending positions of a block are marked by first positioning the 
cursor o ver the first character of the block and then entering the two command sequence, 

I CTRLlfB] followed by [B]. This is followed up be positioning the cursor over the character 
immedi ately following the last character of the block and then entering the sequence, 
I CTRLlfB] followed by fE]. The beginning positioning will be indicated on the display by a 
"begin" marker which is inserted by TED into the text. The marker is displayed as a graphic 
left bracket. The ending position will be indicated on the display by an "end" marker which 
is also inserted by TED into the text. The marker is displayed as a graphic right bracket 
These markers occupy ordinary text positions; thus they may be deleted or overstriked. Any 
remaining in the text buffer at the time a FILE command is performed will be written to the 
disk file just as if they were ordinary text characters. 

Although you can mark as many blocks as your heart desires, TED provides no way to dif¬ 
ferentiate between marked blocks in other than the BLOCK-DELETE function. For copying 
and moving blocks, the first block marked in the text is the one chosen for copying or mov¬ 
ing. On the other hand, a BLOCK-DELETE request requires that the cursor be positioned 
within the interior of the marked block which is to be deleted. 


To COPY the first marked block in the text to some other position, simply mark the begin¬ 
ning and end of the block as discussed above, move the cursor to the position in the text 
where yo u want t he marked block copied into, then invoke the block copy command via the 
sequence, |CTRL|[B] followed by fC]. Note that the block which will be copied is the first 
marked block found in the text buffer, A few things could go wrong with your request. If 
TED can find no properly marked block, it will display the error message Marker! and ter¬ 
minate the block mode. Another error which could occur is when the position you wish the 
block copied into happens to be in the interior of the block itself! Such a block copy can not 
occur. You will be informed of this by a display of the error message Cursor!. 


The successful block copy operation only copies the marked text; the markers are not copied 
as well. If fact, the marked text remains in its original position relative to the text which sur¬ 
rounds it. The cursor position relative to the text will be unchanged after the block is copied; 
however, the screen may be redrawn and the physical location of the cursor on the screen 
may be different. 


A block of text may be MOVED from one position to another by a command sequence simi¬ 
lar to the block copy. In this case, simply mark the beginning and end of the block as dis¬ 
cussed above, move the cursor to the position in the text where you want th e marked block 


moved to, then invoke the block MOVE command via the sequence, |CTRL|[B| followed by 
[Ml . Again note that the block which will be moved is the first marked block found in the 
text buffer. This operation is essentially one of copying and automatic deleting without die 
double check prompt. As in the case of the BLOCK-COPY, the same errors are possible with 
similar diagnostic messages when things are not as they should be. With the BLOCK-MOVE 
command, the new cursor position will be the new position of the moved block. The screen 
may be redrawn and the physical cursor position altered to accommodate this request. 
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This last block operation is deletion. Similar to the above functions, you first must mark the 
block’s beginning and ending positions. You must then positio n the cu rsor to the interior of 
the marked block and invoke the command with the sequence, |CTRL|[B] followed by [D] . 
As a safe ty check, TED will prompt you before deleting the block. It is necessary to depress 
ENTER | to affirm your intentions. Any other character entry (including a [Y]) will cause 
TED to ignore the block delete request. 

The same errors as for copy and move can occur; however, the messages may not be for the 
same reasons. When a block delete is required, TED will first look for an ending block mark¬ 
er starting from the cursor position. If none is found, the error displayed will be Marker!. 
This doesn’t mean necessarily that a properly marked block is missing. On the other hand, if 
an ending marker is found past the cursor position, TED next scans forward for a beginning 
block marker. A Marker! error will also be posted if none is found. If a marker is found 
but is also past the cursor position, a Cursor! error will be posted. 

Filing away your text to a disk file 

The ICTRLlfF] co mmand i s used to save the contents of the text buffer area into a disk file. 
When you depress lCTRL||Tl , you will be prompted for the name of the file. If the file 
specification you wish to use has an extension of "/TXT”, you do not have to enter the exten¬ 
sion. If the extension is omitted from your entry, "/TXT’ will be automatically provided. 

The FILE command will save the entire text buffer, excluding the terminating NULL but in¬ 
cluding any block markers, into the disk file identified by your input. If any disk write error 
is encountered while saving the text buffer into the disk file, the message I/O error! will 
be displayed. In any case, the text buffer is left undisturbed. 

Text search 


TED provides the SEARCH command to scan the text buffer for a s 
ters. You specify the search by invoking the command with 
you for the search string with the query message String?. 


for a specif 
ICTRLl i^l. 


ified string of charac- 
TED then prompts 


You can ente r up to 23 cha racters to be used for the search string. Terminate your search 
string with an |ENTER! (the [ENTER! character code is not included as one of the 23 charac¬ 
ters). TED will then look for the string starting with the first character immediately following 
the cursor. The matching is case sensitive which means that characters entered in upper case 
must be found in upper case and characters entered in lower case must be found in lower 
case. If the search string cannot be found, the message Can't! will be displayed. At this 
point, the cursor location remains unchanged. If, on the other hand, a matching string of text 
is found in the text buffer, it will be displayed. The display window will be redrawn starting 
with the line which contains that string. The cursor will be positioned to the first character of 
the matching string. 

If you press | ENTER! only in response to the String? query, then the search will proceed 
with the last entered search string, provided one was available. Using this procedure, you can 
advance the cursor to each occurrence of the search strings in question. 

Another way to find e ach occurrence of a string is wi th the G O command, |CTRL|[Tj 1 . Each 
depression of ICTRLlfG] is identical to the sequence, |CTRL|fSl followed by |ENTER] . 
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Text search and replace 

TED also provides the capability of replacing a text string matching a search string with a dif¬ 
ferent string - the replacement string. When the REPLACE command is invoked via 
CTRLIfR] , the query message String? will be displayed. Although the message is the 
same as for SEARCH, this query is asking you for the replacement character string. You can 
enter up to 23 characters to be used for the replacement string. Terminate your string with an 
|ENTER| (the 1 ENTER) character code is not included as one of the 23 characters). TED 
will then look for the currently pending SEARCH string starting with the first character IM¬ 
MEDIATELY under the cursor. If the SEARCH string cannot be found, the message 
Can't! will be displayed. At this point, the cursor location remains unchanged. If, on the 
other hand, a matching string of text is found in the text buffer, it will be replaced with the 
REPLACE string. The display window will be redrawn starting with the line which contained 
the string which was replaced. The cursor will be repositioned to the first character immedi¬ 
ately following the replacement string. 

If you wish to replace the next occurrence of text which matche s up wit h the SE ARCH st ring 
with that same REPLACEMENT string, all you need do is enter |CTRLIfR] and |ENTER) . 

The GO command, ICTRLlfG] , still functions to find the next occurrence of the SEARCH 
string. Knowing this, if the next occurmce of the search string is beyond the text currently 
displayed on the screen and you wish to confirm its replacement, simply GO to the next oc¬ 
currence then REPLACE, as necessary. 

Printing text 

TED provides no facility for printing your text file. The most reasonable way of accommo¬ 
dating that function is with the LIST command provided as part of your DOS. 

Exiting from TED 

It is easy to exit TED and return to DOS Ready. The | CLEAR|) Shtibl| [^] command tells 
TED you wish to exit. If the text buffer is empty, TED will immediately terminate. Howev¬ 
er, if there is any text in the buffer, you are provided an opportunity to retract your request 
TED will display the prompt message, 

Press ENTER to exit 

Text recovery 

There may be times when you exit the TED application inadvertantly without saving the edit¬ 
ed text to a disk file. TED permits you to re-enter with the asterisk parameter which provides 
a chance to recover you text. Instead of automatically clearing the text buffer as TED does, 
TED * will display whatever is in the text buffer memory area. Thus, if you have not altered 
any of the information in that memory area, you can always go back and recapture it 

Caution: Since all of the text pointers normally established by TED will not be initialized 
when invoking TED via the * parameter, it will be necessary to scroll through the text until 
reaching its last character prior to doing any other operation. This may also be performed us¬ 
ing NEXT PAGE. 
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Changes and Additions to BASIC 

The changes and additions to BASIC involve a new parameter for the renumber command, 
the addition of several "immediate action" keys, single letter abbreviations, high speed load 
and save, and an interface to DOS SVCs. 

The RENUM statement now allows for a fourth line number to be used. If used, it will be 
the last line of the program to be renumbered. For example: 

RENUM 1000,500,10,600 

This will renumber the lines between 500 and 600 only, making new line numbers starting at 
1000 with an increment of 10. All other restrictions of the current renumber command still 
apply. For moving blocks of lines in a program, see the C and M commands describing 
below. 

There are 6 "immediate" keys that will function when pressed as the first character of a line. 
The up and down arrows list the previous and next line of a program, respectively. The left 
arrow lists the first program line, and the right arrow lists the last program line. The period 
lists the current line, and the comma enters the edit mode for the current line. 

Several single letter commands have been added to BASIC. Four of these are abbreviations 
for existing commands. 

A - AUTO 
D - DELETE 
E - EDIT 
L - LIST 

These commands work exactly as their full length counterparts, except that no space is neces¬ 
sary between the letter and the line numbers. For example, "LI00-300" is the same as "LIST 
100-300". 

The following four commands are contained in the BASIC/OV2 file. This file must be 
present when using one these commands, or a File not found error will occur. Like 
other BASIC editing commands, the use of these will clear all variable values and close any 
open files. 

C - Copy a single line 

F - Find all references to a line, variable or keyword 
M - Move a block of lines 

S - Search and display a reference to a line, variable, or keyword. 

The Copy command syntax is: C Numl,Num2 

Numl is an existing line number to be copied. Nwri2 is the line number to create, and must 
NOT already exist. No renumbering will be done after the copy. If the line numbers are in¬ 
correct, an Illegal function call error will occur. 

The Find command syntax is: F Object 

Object is either a line number, variable, or keyword. The space after the F is mandatory 
when finding keywords. The resulting display will be all line numbers containing the refer¬ 
enced object. When finding variables, only the first 10 characters of the variable name will 
be significant. Also, type declarations !,%,#,$,( must be used. For example, the command "F 
A" would not find A$ or A(). 
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The Move command syntax is: M Numl JNwnl JNum3 


Numl and Num2 are existing line numbers and define the block of lines to be moved. Num2 
must be greater or equal to Numl. Num3 is an existing line number and is the line to insert 
the moved block after. The moved block of lines will be renumbered by one, and all refer¬ 
ences to these lines (if any) will be corrected. If there is not enought room in memory to 
move the lines, an out of memory error will occur. If this happens, do multiple moves of 
smaller pieces. If the line numbers are non-existant or if there is not enough room between 
Num3 and its following line to fit the block, an Illegal function call error will oc¬ 
cur. For example, if you had program lines 100 and 110, a block of lines moved after line 
100 could be no more than 9 lines long. 

The Search command syntax is: S Object or S 

Object is a line number, variable or keyword. The first line containing the object will be 
displayed. The space after the S is mandatory when searching for keywords. The S with no 
object following will search for the next occurrence of the previous object. Like the Find 
command, variables are limited to 10 significant characters, and any explicit type definitions 
must be used. 

High speed Load and Save 

When using the normal SAVE or LOAD program commands, execution should be two to 
three times faster then before. Programs saved with the ASCII parameter will not enjoy this 
speed increase, either when saving or when loading. 

New user interface to SVC’s 


A user interface to the DOS SVC functions is now provided via the USR statement in 
BASIC. To use this interface, establish an INTEGER array with the first 6 elements contain¬ 
ing the following information that may be needed by the SVC: 


Element 0: 
Element 1: 
Element 2: 
Element 3: 
Element 4: 
Element 5: 


SVC number (Always needed!) 
Value for register pair HL 
Value for register pair DE 
Value for register pair BC 
Value for register pair IY 
Value for register pair IX 


The interface is accomplished by using a normally out of range USR argument, USR 11. To 
execute the SVC, use the syntax USR11(VARPTR(ARRAY(0))). No DEF USR statement is 
required. After the SVC executes, the register pairs will be unloaded back into the array. 
The AF register pair will be placed in array position 0. If the array is not an integer type, or 
if the SVC number is either zero or greater than 127, an Illegal function call error 
will occur. 


The return condition of the SVC can be tested by checking the bits in ARRAY(O). Doing an 
"AND 64" will produce a non-zero value if the Z flag is set Doing an "AND 1" will pro¬ 
duce a non-zero value if the Carry Flag is set. For further explanation of DOS SVC usage 
and returned values, refer to the TRSDOS 6.2 Technical Reference Manual. The following is 
a short example of using the SVC interface. 
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100 DEFINT J,K:DIM J(5)' Important - integer array only for SVC interface 
200 CLS:PRINT TAB(25)"SVC Demonstration Menu" 

210 PRINTtPRINT TAB(25)"1) Set Scroll Protect" 

220 PRINT TAB(25)"2) Toggle Caps Lock" 

230 PRINT TAB(25)”3) Show DOS Version" 

240 PRINT TAB(25)"4) Check Drive Ready" 

250 PRINT:PRINT TAB(25)INPUT "Make a selection ";A$ 

260 IF A$ < "1" OR A$ > "4" THEN 200 

270 A=VAL(A$):ON A GOSUB 1000,2000,3000,4000 

280 GOTO 200 

1000 CLS:PRINT"Set number of scroll protect lines 0-7" 

1010 PRINT:PRINT"0 will cancel scroll protect ";:INPUT A 
1020 IF A < 0 OR A > 7 THEN 1000 

1030 J(3)=&H700 + A 'Register B=7, Register C=line count 
1040 J(0)=15:X=USR11(VARPTR(J(0))) 'Execute <§VDCTL SVC 
1050 IF A=0 THEN RETURN 

1060 FOR K=1 TO 100:PRINT K;"Testing scroll protect to 100":NEXTrRETURN 
2000 CLS:J(0)=101:X=USR11(VARPTR(J(0))) ' (gFLAGS SVC to get keyboard flag 
2010 K=PEEK(J(4)+10)' Get KFLAG value 
2020 POKE (J(4)+10), K XOR 32 'Toggle Caps lock bit 

2030 INPUT"Type some characters to check Caps lock, press ENTER to end ";A$ 

2040 RETURN 

3000 CLS:J(0)=101:X=USR11(VARPTR(J(0)))' Get flag table base, <§FLAG SVC 

3010 K=PEEK(J(4)+27)' Peek out version number, base+27 

3020 K=K-(&H60)' Earliest version was 6.0, K will be 0 to 3 

3030 PRINT "This is DOS version 6 .";K 

3040 PRINT:INPUT"Press ENTER to return"; A$:RETURN 

4000 CLS:INPUT"Enter drive # to check 0 to 7 ";K 

4010 IF K < 0 OR K > 7 THEN RETURN 

4020 J(3)=K' Set drive number for SVC 

4030 J(0)=33:X=USR11(VARPTR(J(0)))' @CKDRV SVC 

4040 PRINT:PRINT”Drive";K;"has "; 

4050 IF (J(0) AND 64)=0 THEN PRINT"no disk mounted.":GOTO 4080 
4060 PRINT"a disk mounted." 

4070 IF (J(0) AND 1)~1 THEN PRINT"The drive is write protected." 

4080 PRINT:INPUT"Press ENTER to return ";A$:RETURN 

This example program shows several methods of accessing information not normally available 
from BASIC. To make effective use of the SVC interface, you will need to have the Model 4 
Technical Reference Manual. 

The @CKDRV routine (lines 4000-4080) shows how the return status of an SVC can be 
checked. The Z flag can be tested by doing an "AND 64" against the array(0) position. If 
the result is zero, the Z flag was NOT set The CF (carry flag) can be tested in the same 
manner by doing an "AND 1". Again, a zero result means die flag was not set. 

The Caps lock and DOS Version subroutines show how information can be referenced in the 
system flag area with the @FLAGS SVC. There are several other flags and system storage 
areas than can also be referenced off of the flag table base. 

Certain SVCs, such as @CMNDI, @CMNDR, or setting the high memory pointer must NOT 
be done. Generally speaking, anything that can be legally be done from BASIC with 
@CMNDR can be done with the SYSTEM "command' statement, and should not be attempt¬ 
ed through the SVC interface. 
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New BASIC Cross Reference Utility 

BREF/CMD is a cross reference utility for BASIC programs. It is executed at the DOS 
Ready prompt, not from inside of BASIC. The BASIC program must NOT have been saved 
in ASCII. The syntax is: 

BREF filespec [(parm,parm,...)] 

Parameters are: 


\AR=ON\OFF - 
LINE=CW|OFF - 
P=ON\OFF 
W=n 


Default is on 
Default is off 
Default is off 

Width for output to printer, Default is 80 


The filespec is the name of the BASIC program. The VAR parameter allows variables to be 
cross referenced. The LINE parameter includes a cross reference of line numbers. The P 
parameter allows the listing to go to a printer rather than the video. The W parameter can be 
used to specify the number of columns for the printer (generally either 80 or 132, although 
any value between 32 to 255 will be accepted). 


Variable names will be displayed up to 14 characters. If the variable is longer than this, the 
remaining characters will be truncated for display. BASIC stores certain keywords in ASCII, 
and this makes them indistinguishable from a variable. For example the "AS" used in field 
statements. This will cause these words to be displayed in a variable cross reference list 

If there are more references than can be displayed on a single line, they will wrap to the next 
line. This line will have an asterisk in column one to denote the overflow. 


Examples 

BREF PROG/BAS - Sends only variable references to the video. 

BREF PROG/BAS (LINE,VAR=OFF) - Sends only line number references to the video. 

BREF PROG/BAS (LINE,P,W=132) - Sends variables and line numbers to a 132 column 
printer. 

Possible errors 


There are three error messages that may be generated by BREF: 

Not a BASIC program 

The general cause of this error is trying to use a program saved in ASCII, a program saved in 
the protected mode, or a non-BASIC program file. 

Out of memory - can't cross reference 

This will occur is the program is too large to fit into your available memory. The cure is to 
change your configuration to free up some memory. 

Line nnnn. Error in original program 

This message may occur if there is a syntax error in the original BASIC program. The line 
number should correspond to that line in the program. 
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TECHNICAL INFORMATION CHANGES 







Changes to directory structure 

GAT - The disk type byte (GAT+CDH) now assigns bit 3 as the date type bit If this bit is 
set, the disk is assumed to use the new time/date fields. 

DIR+2 - This byte continues to hold the day in bits 3-7 as documented for earlier versions. 
However, bits 0-2 should no longer be considered the primary year field. For compatibility 
with earlier versions, these bits should remain untouched by the user as certain system rou¬ 
tines will modify this area. 

DIR+18,19 - These two bytes are no longer assigned as the user password. Instead, they con¬ 
tain the new style time/year information as follows: 

DIR+18 - bits 3-7 contain the hour. 

bits 0-2 contain the most significant bits of the minute. 

DIR+19 - bits 5-7 contain the least significant bits of the minute, 
bits 4-0 contain the year offset from 1980. 


Changes to SVCs 

(2>CKDRV - This SVC now adjusts the appropriate bit in the Y flag to reflect GAT+CDH, bit 
3 (the old or new style date bit) for the drive being accessed. 

@FLAGS - The ’Y’ flag byte has been assigned to mark the dating style of a disk. Bits 0 to 
7 correspond to drives 0 to 7. If the bit is set, the drive is assumed to use the new style 
time/date information. The setting and resetting of this bit is handled by the @CKDRV SVC. 
The operating system version (flag table base+27) has been set to 63H. The release number 
(flag table base-47) has been set to 00H. 

@HEXD - NEW SVC, number 95. (Similar to @HEXDEC SVC, number 97) 

Converts a binary number in HL to decimal ASCII. 

Entry conditions: 

A = 95 (X’5F) 

B = expected number of output digits 
HL = number to convert 

DE = pointer to buffer to hold converted number 

Exit conditions: Success always. 

DE = pointer to end of buffer+1 
AF, BC, HL are affected by this SVC 

This SVC is the same as @HEXDEC except that a 5 character buffer is not required. Instead, 
the B register should contain the maximum number of output characters expected, and DE 
should point to a buffer of at least that size. If the conversion exceeds this number of charac¬ 
ters, the overflow will be placed in memory below the buffer pointed to by DE. 

@INIT - If a file is created with a password, the protection level will now be set to NO. This 
means that no future access will be given without the use of the password. 

<§>VDPRT - NEW SVC, number 107. This SVC performs a screen print. If the printer is not 
ready, the SVC will abort in approximately 20 seconds. 

Entry conditions: A=107 (X’6B’) 

Exit conditions: Success always. 

BC, DE, HL are changed. No status is returned. 
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SOFTWARE LICENSE AGREEMENT 


The LS-DOS 6.3 software update provided by Logical Systems, Incorporated (LSI) is intended 
only for legitimate owners of a TRSDOS 6.x operating system. By accepting this software 
license, the buyer expressly warrants and represents that he is a legitimate owner of a 
TRSDOS 6.x operating system. 

The LS-DOS 6.3 software update and documentation is copyrighted with all rights reserved 
by Logical Systems Incorporated. The buyer is granted a license to use this software on one 
computer system, and may make copies for personal use and archival purposes only. Copying 
this software for sale or other distribution is expressly prohibited. 

LIMITED WARRANTY 

LSI warrants the diskette media on which the LS-DOS 6.3 is recorded to be free from defects 
under normal use for a period of 30 days after the date of original purchase. If during this 30 
day period a defect in the diskette media should occur, you may return the diskette to LSI for 
replacement without charge. 

Except as provided for above, LSI makes no warranties, either expressed or implted, with 
respect to this software or its fitness for any purpose. LSI software is provided "as-is". 
Should the software prove defective, the buyer assumes the entire cost of all necessary servic¬ 
ing, repair, or correction and any incidental or consequental damages. LSI assumes no liabili¬ 
ty for direct, indirect, incidental or consequental damages resulting from any use of or any de¬ 
fects in the software. 


CUSTOMER SERVICE 

Each LS-DOS 6.3 contains its own individual serial number and customer service l.D. 
number. Your customer service l.D. number is very important and must be included if 
you write to LSI for service or your letter will be ignored. You must also have this 
number available when calling our customer service department, in either case you 

must first have filled out and returned your registration card, do NOT DELAY under 

no circumstance will customer service be provided to unregistered owners. 

For customer service contact: 

LSI 

CUSTOMER SERVICE DEPT. 

P.O. BOX 55235 

Grand Junction, CO 81505 

NOTE: Customer service phone hours are 9 a.m. to 12 noon, Mountain time. 

Phone: (303) 242-2929 
9 a.m. to 12 noon 

WARNING 

Tampering with the serial number or customer service number or 
the other security and control systems in the LS-DOS 6.3 product 
will cause the system to fail possibly causing damage to or loss of 
data. Remember each system is licensed for use on ONE machine, 
LSI has taken certain steps to see to it this license is not violated and 
assumes no responsibility whatsoever regarding damage that may 
result from violation of this license. 
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ABOUT LSI SUPPORT SERVICES 


ADDENDUM #1 


In a product as complicated and as large as an operating system there will always be 
problems found that are in need of correction. In an ongoing effort to support LS-DOS 
6.3.x LSI will from time to time issue a revision statement. You may, in most cases, make 
the revisions yourself or you may send your MASTER disk in for updating. 

LSI has categorized revisions to fall into two categories. These consist of CRITICAL 
REVISIONS and NON-CRITICAL REVISIONS. A CRITICAL revision is a revision that corrects a 
problem that could cause damage to, or loss of data. ALL other revisions are considered 
NON-CRITICAL. In the event that a CRITICAL revision is issued all registered LS-DOS 6.3 
users will be notified by mail. When we create NON-CRITICAL revisions there will be no 
individual notification. ALL revisions will be available on the LDOS SIG on COMPUSERVE and 
will be published in our column in THE MISOSYS QUARTERLY, which you can subscribe to by 
contacting MISOSYS at (703) 450-4181. Should you run into a problem with 6.3 that you 
consider a "bug" our Customer Service Department wants very much to hear from you. Most 
likely we will already have corrected that problem and will fire off a copy of the 
correcting patch by First Class mail. If you are the first to make us aware of the problem 
we will give it our most sincere attention. We will also be glad to provide complete 
revision statements (patches, etc.) to anyone requesting them, make sure you include your 
customer service ID#, with your request, it lets us know what revisions apply to your copy 
of the system. 

The effort needed to create PATCH files and get the patches correctly installed is 
tedious, time consuming and subject to human error. For these reasons LSI has instituted 
the following update policy for LS-DOS: 

LSI will update your MASTER disk for a service, handling and 
shipping fee of JUST $5.00 per disk update. With each update 
we will include an outline of what corrections have been made. 

To receive this service you must return your original BEIGE LSI 
MASTER disk along with a check or money order for $5.00 to: 

Logical System, Inc. 

Update Department 

PO Box 55235 

Grand Junction, CO. 81505 

LSI will also provide a REPLACEMENT MASTER disk to a registered 
user, for $10.00. It will be shipped to your REGISTERED address 
only. You must include your Customer Service Number (CS#) when 
requesting a replacement disk and include a check or money order 
for $10.00 with your request. (NO CODs, CREDIT CARDS OR P.O.s). 

Outside of U.S. or Canada, add $3.00 for update or replacement. 

It should be noted that this is the same disk update policy that LSI has had for over five 
years. Because we have a simple and inexpensive way for our users to update their system 
in an accurate and controlled manner, we will NOT help in any way with the creation, 

installation or implementation of upgrade patches for the system. What we are saying is 

that if you cannot deal with, or are uncomfortable with patch installation totally on your 
own, then SEND IN YOUR DISK FOR UPDATING, as stated above. 

We would like to point out that we do provide LS-DOS 6.3 as an "AS IS" product. No 
warranty of ANY kind is stated or implied. LSI has always tried to provide a reasonable 

level of support for our products and we hope to continue to do so, but we are not 

obligated to any service, update, error correction or ongoing support policy. Our policies 
may change from time to time and we feel that changing our policies on "AS IS" products is 
our right. LS-DOS 6.3 is provided to you at a very nominal fee. We simply do not make 
enough profit to provide unlimited, free services at this level of pricing. 
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Please consider the position of the authors of CPM and MSDOS, neither provide anywhere 
near the level of phone and mail customer service that LSI provides and their products 
cost much more. When CPM and MSDOS are updated or revised (even to correct their own 
errors) in most cases, you must simply BUY the new version, as of now the "latest and 
greatest" version of MSDOS is somewhat over $100.00. At LSI we have paid a total of OVER 
$1800.00 over the last five years to keep current with MSDOS/PCDOS revisions. In the same 
time frame a TRSDOS 6.x and LS-DOS 6.3 user could not have paid more then a total of 
$95.00 to keep his DOS current, quite a difference we think. Try calling one of the other 
DOS authors and getting your questions answered, at least we are willing to TALK directly 
to our users. 

We are sure you can cite some situations where other software companies have provided 
excellent service and stood behind their products, with nominal or no fees, but remember 
LSI has a NINE YEAR track record of such service. Also, how good has your support been on 
other $29 or $39 products?? So, please do not complain to us about our support policies, 
if anything our support policies and services will become LESS liberal, and MORE expensive 
in the future, due to simple economics. LSI also reserves the right to totally terminate 
support for any product sold "AS IS", without notice. 

LSI RETURN POLICY 


Should you find any the LSI support policy, or the "AS IS" condition under which LS-DOS is 
provided, unacceptable to you, OR FOR ANY OTHER REASON, you may return your LS-DOS 6.3, 
within 10 days of receipt, for a full refund. If you purchased on a credit card, please 
include the card number and expiration date so we can properly credit your account. Note: 
You must return the product completely intact and in resalable condition to receive a 
refund. NOTE: This policy became effective on 02/10/87. 

Simply stated: WE WANT YOU TO BE A SATISFIED CUSTOMER. 


WORKING WITH OUR CUSTOMER SERVICE DEPARTMENT 


Our customer service department will be happy to answer any question about the use and 
function of LS-DOS 6.3.x. by either written request or by phone. When making a written 
request be as specific as possible and include as much information as possible: screen 
prints, copies of disks, printouts, exact keyboard sequences, error messages, etc. are all 
helpful. Remember, vague questions will get vague responses. When calling customer service 
it is best if you can be at your computer so we can have you check things, however this is 
not a requirement. Always include your CS# (NOT your serial #) on your correspondence with 
LSI or it will have to be ignored, sorry, there are no exceptions. Also, PLEASE provide us 
with a phone number where we can reach you, a DAY and EVENING number helps. We return all 
answers to the registered address for that CS# and each one IS checked. 

IMPORTANT: WHEN PHONING OUR CUSTOMER SERVICE DEPARTMENT YOU MUST USE THE PHONE NUMBER FOR 
CUSTOMER SERVICE (SEE PAGE 16 OF YOUR 6.3 DOCUMENTATION). CALLING OUR MAIN NUMBER WON'T 
GET YOU TO THE RIGHT PLACE. THE CUSTOMER SERVICE DEPARTMENT IS IN A SEPARATE PART OF OUR 
BUILDING AND HAS A SEPARATE PHONE SYSTEM. 

Please do NOT ask questions about products other then LS-DOS 6.3 as we probably do not 
know the answers. If you have a program that does not work on 6.3, it is most likely not 
the fault of LSI. The entire program interface, as documented for 6.2.x is identical to 
that of 6.3.x. So if a program fails to run identically on 6.2 and 6.3, it is probably the 
fault of the author of that program, NOT LSI. To get the program to run correctly on 6.3 
you will have to contact the author/supplier of that program. If that can not be done you 
may have to be content to run the product on 6.2.x. The fact that it may run just fine on 
6.2 and does not run on 6.3 is of great concern to us, but does not mean 6.3 is at fault 
in any way. Any program that does not run correctly on 6.3, but did on 6.2, has probably 
violated documented interface standards and the program is at fault. 
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There are THOUSANDS of programs being run on the Model-4 and it would be impossible to 
support all of them, especially when we are providing LS-DOS at such a small cost to the 
user. In most cases we do not even have the program you are asking about, much less the 
source code for that program. Our policy will be very firm -<>- Users can NOT rely SOLELY 
on LSI for assistance with products other then LS-DOS 6.3.x itself -<>- This does not mean 
that if we have information that can be of help to you that we won't tell you, we will. 

But in most cases we just won't have any knowledge that would be of help. 

There are places to get useful information about applications running on your Model-4. 
Users of the Model-4 system should subscribe to "80-MICRO" magazine. You should be a 
member of COMPUSERVE and check in to the LDOS special interest group bulletin board on a 
regular basis. This is an excellent place to ask questions, any questions, and get answers 
from other users. Another great source of accurate and timely information is THE MISOSYS 
QUARTERLY, call MISOSYS at (703) 450-4181. 

We will answer technical questions about LS-DOS, BUT IN A GENERAL SENSE ONLY. This means 
we will try to answer questions if the answer is to provide general information about our 
system and its function. We will not answer specific PROGRAMMING QUESTIONS. If you wish to 
program over LS-DOS 6.3 you should have the technical reference manual from Tandy 
(26-2119) and the "Programmers Guide to TRSDOS 6.x" from Diskcount Data and the "SOURCE 
CODE TO 6.2" from MISOSYS without these you will be lost. Great amounts of accurate 
technical information and a special LS-DOS section dedicated to your 6.3 system are also 
available in THE MISOSYS QUARTERLY, from MISOSYS. 

Normally we will not provide patches to custom configure your system. Patches to change 
system defaults and to modify system functions may become available from sources other 
then LSI. Please do not expect LSI to get involved with these in any way. However, LSI may 
from time to time issue an optional patch to alter a default or modify a function. If we 
do, we will publish it and support it. LSI will decide if, when, how, and what to offer an 
optional patch for. 


HERE ARE THE ANSWERS TO THE MOST COMMON USER PROBLEMS 


*** QUESTION: 

I JUST RECEIVED MY 6.3 DISK AND I GET A PARITY ERROR (OR OTHER READ ERROR) WHEN I TRY TO 
MAKE A COPY OF THE MASTER, OR MY MASTER DISK WON'T EVEN BOOT ?? 

ANSWER: 

The drives that we produced your MASTER disk on are kept in near perfect alignment and 
checked daily. This type of problem is most likely to occur if your Drive :0 is slightly 
out of alignment. Try this: 

> BOOT UP with a 6.2 disk as you normally would. 

> Place your LSI MASTER 6.3 in drive :1 

> Do the command: DISKCOPY.UTILITY :1 :0 <ENTER> 

> At the insert disks prompt, place a blank disk in Drive :0 

> Press <ENTER> 

If this procedure goes through without an ERROR message then you have succeeded in 
duplicating your MASTER disk to your drive :0. The disk in drive :0 will now be a fully 
functional and usable system in your boot drive. BUT, your drive :0 should be realigned. 

If this procedure does not complete without ERROR then your MASTER disk probably is 
defective or was damaged in shipping. DON'T PANIC - just let us know and we will send you 
a fresh one in a RIGID, ANTI-STATIC package, and do it quickly. 


*** QUESTION: 

HOW DO I ENABLE MORE FLOPPY DISK DRIVES WITH MY LS-DOS 6.3 ?? 
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ANSWER: 

The easiest way is to refer to the SYSTEM command in your manual for information on 
ENABLING and DISABLING drives. The SYSGEN command will then save these desired states and 
initialize them when you boot up. The commands you would use to enable 2 additional drives 
as drives #2 and #3 are: 

SYSTEM (DRIVE=2,ENABLE) <ENTER> 

SYSTEM (DRIVE=3,ENABLE) <ENTER> 

SYSGEN <ENTER> 

This is all there is to it. simple and straight from the 6.2.0 manual. 

Another way would be to "PATCH" the operating system so that the drives are enabled from 
the start. Although this is NOT the recommended method, it is safe and can be used without 
problems. To make these patches you would execute the following commands: 

PATCH BOOT/SYS.LSID0S:0 (D02,84=C3:F02,84=C9) <ENTER> 

PATCH BOOT/SYS.LSID0S:0 (D02,8E=C3:F02,8E=C9) <ENTER> 

Note: The first patch line ENABLES drive #2 the second patch line ENABLES drive #3. You 
must re-BOOT after installing for these patches to take effect. 

One other method of turning on extra drives or other "environment" arrangements is to put 
them in a JCL file called INIT/JCL and then set an "AUTO DO INIT" on your boot disk. This 
method is most frequently used at LSI. 


*** QUESTION: 

I WANT TO GET A COPY OF THE CURRENT 6.2 USER AND/OR TECHNICAL REFERENCE MANUAL, WHAT DO I 
DO? 

ANSWER: 

Simple, get in touch with Radio Shack, the current 6.2 user manual is available as part 
#26-0316, the technical reference manual is part #26-2119. If you do not have these or 
have old versions LSI would recommend that you obtain them while you can. 


*** QUESTION: 

DATECONV GIVES A MESSAGE "CAN'T CONVERT DATES ON NON-6.3 SYSTEM DISKS"?? 

*** ANSWER: 

Very simple to correct. At one time the disks' directory was marked as being a "SYSTEM" 
type disk. This can occur in several ways, none of which are damaging to your data. Why it 
happened is really not important at this point so let's cure it. LSI suspected that this 
may become a problem for some of our users so we provided an "undocumented parameter" to 
override the checking in for this DATECONV. Use the command: 

DATECONV :d (CS) <ENTER> 

The (CS) is the parameter, it simply stands for Customer Service. This overrides the 
protection for NON-6.3 system disks, so be careful. Check any disk you use this on to make 
sure that it has only the /SYS files BOOT and DIR, if any other /SYS files are on the disk 
DO NOT USE THE CS PARAMETER!!! These /SYS files must be PURGED before you proceed. The 
(CS) parameter is to BE USED ON DATA DISKS ONLY. 


*** QUESTION: 

HOW DO I MAKE A DOUBLE SIDED SYSTEM DISK THAT WILL BE LAID OUT CORRECTLY ?? 

ANSWER: 

The main reason to have a system disk laid out "CORRECTLY" is so the system modules will 
be clustered around the directory to reduce access time to these frequently used /SYS 
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files. Here is a very simple JCL which will do just that. 


. DOUBLE/JCL 

. JCL Procedure to create a double sided SYSTEM disk 
. SOURCE (S) and DESTINATION (D) must be set on JCL COMMAND LINE 

FORMAT :#D# (SIDES=2,ABS,NAME="LSDOS63",Q=N) 

MEMORY (A="A",B=17) 

BACKUP /SYS:#S# :#D# (S) 

MEMORY (A="A\B=11) 

BACKUP :#S# :#D# (I) 

MEMORY (A="A",B=1) 

. A correctly structured, double sided SYSTEM disk has been created. 
. END 


The above commands can of course be entered as individual commands at DOS ready with the 
same results. For convenience and accuracy we at LSI tend to use this JCL. The important 
part of this procedure is the use of the MEMORY command to set the "A" flag. This is the 
Allocation flag for the operating system and the number in this flag is the track on the 
disk where the file placement system will start to search for space on the disk. 

This is a very valuable thing to know about and use. This will allow you to structure your 
own disks in any manner that you wish, and to restructure and repack disks for efficiency. 
The normal setting of the "A" flag is for track #1. 

YES, those of you with hard drive should use a similar method when applying the system to 
your drive. Start the /SYS backup 2 tracks below the directory of your hard drive, by 
setting the "A" flag accordingly. Do the rest of the backup starting about 5 tracks below 
the directory. If you did not do something like this when you first set up your hard 
drive, you should reformat and do so now. This optimizing of the system on your hard drive 
will greatly increase the overall speed of your system. 


*** QUESTION: 

ON 6.2 I HAD A PATCH TO HAVE FORMAT DEFAULT TO DOUBLE SIDED, DOUBLE DENSITY AND 40 TRACKS. 
WHAT IS THE PATCH FOR THIS ON 6.3 ?? 

ANSWER: 

If the patch that you were using for 6.2 was: 

PATCH FORMAT/CMD.UTILITY (D09,5B=02:F09,5B=00) <ENTER> 

Then on 6.3 it would be: 

PATCH FORMAT/CMD.UTILITY (D09,65=02:F09,65=00) <ENTER> 

FORMAT will now default to DD/DS-40 track format. If you want a different format you will 
now have to specify same in the command line for format (see FORMAT in your 6.2 manual). 
NOTE: THIS IS WHY LSI DOES NOT RECOMMEND THIS PATCH!! Users forget that they have made 
this patch and then call us saying "Your system is NO GOOD it won't even let me format a 
single sided disk". 


*** QUESTION: 

I FOLLOWED ALL THE INSTRUCTIONS FOR UPDATING MY HARD DRIVE SYSTEM BUT I STILL CAN'T SEEM 
TO GET IT TO WORK PROPERLY WHAT DO I DO ?? 

ANSWER: 

The instructions for updating your hard drive system will work in almost all cases, but 
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there are some systems that will require another method. If your system is one of the odd 
ones you can try a RE-SETUP. 

NOTE: BEFORE DOING ANY UPGRADE TO A HARD DRIVE, IT IS EXPECTED THAT YOU WILL HAVE MADE A 
COMPLETE BACKUP OF ALL THE IMPORTANT DATA AND FILES OFF OF THAT HARD DRIVE BEFORE YOU 
BEGIN. THIS IS ONLY COMMON SENSE. 

First you MUST start with a CLEAN exact copy of your LS-DOS 6.3 DISK made with DISKCOPY. 
Next using PURGE or REMOVE get rid of some files you won't be needing on this disk, 
keeping in mind that this is to become your BOOT DISK. We suggest you REMOVE DOS/HLP, this 
should give you amble room on the disk. 

Now, using COPY, put your hard disk DRIVER program onto this disk, this is the program 
used to set up your hard drive that has the extension /DCT. Then copy the hard disk 
formatting program that came with your system onto the disk. 

Now you must refer to the documentation that came with your hard disk software and perform 
a manual SETUP of the hard drive. You must set up the drive in such a manner that it will 
be partitioned in the identical manner as it was before you began your upgrading. If a 
SYSTEM (SYSTEM=d) command is requested as part of the setup DO NOT DO IT YET. 

If all has gone well you should now have your hard drive accessible now. Test this by 
doing a DIR on each of the logical drive numbers now designated to be on your hard drive. 
If everything seems correct you should now put 6.3.0 onto the hard drive surface that 
contained your 6.2.0 do this with: 

BACKUP :0 :d (S,I) <ENTER> 

If you have followed the instruction drive 0 should still contain a fresh 6.3.0 that is 
missing the DOS/HLP file. Replace the "d" in the backup command with the present logical 
drive number for the hard drive partition that will become drive 0. 

After the BACKUP has completed you should do a: 

SYSTEM (SYSTEM=d) <ENTER> 

Replace the "d" above with the same drive number used in the backup above. This will swap 
drive 0 with drive "d". Test things a bit by doing a DIR:0. If all is well you should get 
the directory of your hard drive SYSTEM platter. If this checks out OK then is time to 
save things, so do a: 

SYSGEN (DRIVE=d) <ENTER> 

Again replace the "d" with the same drive number as before. This will cause this SYSGEN to 
go to the 6.3.0 floppy that is in the PHYSICAL drive position :0. You should now be able 
to RESET the system and it should end up running correctly. 

If you will be using the HELP command you should copy DOS/HLP onto hard drive :0 from a 
fresh copy of 6.3.0. This will complete the setup of the system. You now can reboot and 
then add any addition setup you may require in your SYSGEN or create an AUTO function. 

Just make sure that any SYSGEN or AUTO you do is specified to the BOOT floppy drive #. 

If the above procedure fails in any way you will have to contact the company that provided 
you with your DRIVER AND FORMATTER for the hard drive. You may have to RE-FORMAT the whole 
drive or something else. DO NOT call LSI unless you are using the OFFICIAL Radio Shack 
driver and formatter, these are the ones we wrote and understand. There are many other 
drivers and formatters out there for drives other than Radio Shacks or for special 
purposes. We can't help with those, sorry. 


*** QUESTION: 

HOW CAN I MAKE A BUNCH OF BLANK, FORMATTED DISKS, REAL QUICK ?? 
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ANSWER: 

Format a blank disk in the normal fashion using the FORMAT command in LS-DOS 6.3. Now 
simply use DISKCOPY to make copies of this blank disk. DISKCOPY is very smart and only 
duplicates tracks that contain real data, blank tracks are just formatted and verified. 
Try it, you will be amazed at the speed. 


*** QUESTION: 

HOW LONG IS LSI GOING TO SUPPORT LS-DOS 6.3.0 ON THE MODEL-4 ?? 

ANSWER: 

Honestly, at this time we don't know. Three things will be given consideration in 
determining when we will stop. First, as long as there are enough questions and interest 
from users to justify keeping a customer service department running we will try to do so. 
Second, we will have to feel confident that there are NO serious problems with the 
Operating System that would require our attention. Lastly we MUST consider economics: 
LS-DOS 6.3.0 is not an expensive product, LSI HAS TO SHIP OVER 500 COPIES PER MONTH JUST 
TO BREAK EVEN. When the cash flow stops the support may have to stop, there simply may not 
be an alternative. But we will do the best we can. 

Full support of LS-DOS will certainly continue through all of 1987 and most likely through 
most of 1988, possibly much longer. 

We are considering offering a Support and Update Newsletter (The S.U.N.) which would 
contain tips on usage, technical information, patches to the system and answers to common 
questions and problems for users of LS-DOS. In the future, a publication like this may be 
the only way that LSI will provide update information to our users. We would have to 
charge about $20 per year for this type of service publication. Please, let us know if you 
would be interested in such a publication. 


*** QUESTION: 

THE ANTI-PIRACY PROTECTION SCHEME ON LS-DOS 6.3 SCARES ME. I'M AFRAID SOMETHING MIGHT GO 
WRONG WITH IT AND I WILL LOSE VALUABLE DATA ?? 

ANSWER: 

Not to worry. You are right to assume that the protection system is VERY sophisticated, it 
cannot even be found using any conventional software technique. LSI spent much time and 
effort in the design and testing of this protection system and we can assure you that: 

"NO MATTER WHAT HAPPENS, NO LEGITIMATE USERS WILL EVER LOSE DATA OR HAVE ANY OTHER PROBLEM 
WITH THIS PROTECTION SYSTEM" - "PIRATES OR USERS WHO VIOLATE OUR LICENSE AGREEMENT WILL 
HAVE TROUBLE WITH THE SYSTEM" 

We will know if, and when, a violation occurs based on the problems that are reported by 
the user. But, under no circumstances will the PROTECTION SYSTEM ever damage DATA. 

************ OUR PARTING COMMENT *********** 

ALL USERS: Please do yourself a BIG favor and carefully read the following sections of 
your TRSDOS Version 6 Reference Manual: BACKUP / FORMAT / SYSTEM / SYSGEN. 

A very large portion of the questions we get from users could be answered if the user had 
a clear understanding of ALL the functions in these four areas of the TRSDOS and LS-DOS 
systems. 
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